home *** CD-ROM | disk | FTP | other *** search
/ IRIX 6.5 Complementary Applications 2004 February / SGI IRIX 6.5 Complementary Applications 2004 February.iso / dist / cde.idb / usr / dt / share / man / cat3 / XmVaCreateSimpleMenuBar.z / XmVaCreateSimpleMenuBar
Encoding:
Text File  |  2003-11-18  |  5.0 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXmmmmVVVVaaaaCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeeMMMMeeeennnnuuuuBBBBaaaarrrr((((3333XXXX))))UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVVXXXXmmmmVVVVaaaaCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeeMMMMeeeennnnuuuuBBBBaaaarrrr((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       _X_m_V_a_C_r_e_a_t_e_S_i_m_p_l_e_M_e_n_u_B_a_r - A RowColumn    widget convenience
  10.       creation function
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.       #include <Xm/RowColumn.h>
  14.  
  15.       Widget XmVaCreateSimpleMenuBar (ppppaaaarrrreeeennnntttt,,,, nnnnaaaammmmeeee,,,,    aaaarrrrgggg............)
  16.            _W_i_d_g_e_t     ppppaaaarrrreeeennnntttt;
  17.            _S_t_r_i_n_g     nnnnaaaammmmeeee;
  18.  
  19.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  20.       _X_m_V_a_C_r_e_a_t_e_S_i_m_p_l_e_M_e_n_u_B_a_r creates an instance of a RowColumn
  21.       widget of type _X_m_M_E_N_U__B_A_R and    returns    the associated widget
  22.       ID.  This routine uses the ANSI C variable-length argument
  23.       list (varargs) calling convention.
  24.  
  25.       This routine creates a MenuBar and its CascadeButtonGadget
  26.       children.  The name of each button is    button_nnnn, where    nnnn is
  27.       an integer from 0 to one minus the number of buttons in the
  28.       menu.     Buttons are named and created in the order in which
  29.       they are specified in    the variable portion of    the argument
  30.       list.
  31.  
  32.       ppppaaaarrrreeeennnntttt
  33.            Specifies the parent widget ID
  34.  
  35.       nnnnaaaammmmeeee Specifies the name of the created widget
  36.  
  37.       The variable portion of the argument list consists of    groups
  38.       of arguments.     The first argument in each group is a
  39.       constant or a    string and determines which arguments follow
  40.       in that group.  The last argument in the list    must be    NULL.
  41.       Following are    the possible first arguments in    each group of
  42.       varargs:
  43.  
  44.       _X_m_V_a_C_A_S_C_A_D_E_B_U_T_T_O_N
  45.            This is followed    by two additional arguments.  The set
  46.            specifies one button in the MenuBar and some of its
  47.            resource    values.     Following are the additional two
  48.            arguments, in this order:
  49.  
  50.       llllaaaabbbbeeeellll
  51.            The label string, of type XmString.
  52.  
  53.       mmmmnnnneeeemmmmoooonnnniiiicccc
  54.            The mnemonic, of    type KeySym.  This is followed by one
  55.            additional argument, the    value of the resource, of type
  56.            XtArgVal.  The pair specifies a resource    and its    value
  57.            for the RowColumn widget.  This is followed by four
  58.            additional arguments.  The set specifies    a resource and
  59.            its value for the RowColumn widget.  A resource type
  60.  
  61.  
  62.  
  63.      Page 1                        (printed 11/11/03)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXmmmmVVVVaaaaCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeeMMMMeeeennnnuuuuBBBBaaaarrrr((((3333XXXX))))UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVVXXXXmmmmVVVVaaaaCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeeMMMMeeeennnnuuuuBBBBaaaarrrr((((3333XXXX))))
  71.  
  72.  
  73.  
  74.            conversion is performed if necessary.  Following    are
  75.            the additional four arguments, in this order:
  76.  
  77.       nnnnaaaammmmeeee The resource name, of type String.
  78.  
  79.       ttttyyyyppppeeee The type    of the resource    value supplied,    of type
  80.            String.
  81.  
  82.       vvvvaaaalllluuuueeee
  83.            The resource value (or a    pointer    to the resource    value,
  84.            depending on the    type and size of the value), of    type
  85.            XtArgVal.
  86.  
  87.       ssssiiiizzzzeeee The size    of the resource    value in bytes,    of type    int.
  88.            This is followed    by one additional argument of type
  89.            XtVarArgsList.  This argument is    a nested list of
  90.            varargs returned    by _X_t_V_a_C_r_e_a_t_e_A_r_g_s_L_i_s_t.
  91.  
  92.       For more information on variable-length argument lists, see
  93.       the X    Toolkit    Intrinsics documentation.
  94.  
  95.       A number of resources    exist specifically for use with    this
  96.       and other simple menu    creation routines.  For    a complete
  97.       definition of    RowColumn and its associated resources,    see
  98.       _X_m_R_o_w_C_o_l_u_m_n(_3_X).
  99.  
  100.      RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  101.       Returns the RowColumn    widget ID.
  102.  
  103.      RRRREEEELLLLAAAATTTTEEEEDDDD IIIINNNNFFFFOOOORRRRMMMMAAAATTTTIIIIOOOONNNN
  104.       _X_m_C_r_e_a_t_e_M_e_n_u_B_a_r(_3_X), _X_m_C_r_e_a_t_e_R_o_w_C_o_l_u_m_n(_3_X),
  105.       _X_m_C_r_e_a_t_e_S_i_m_p_l_e_M_e_n_u_B_a_r(_3_X), and _X_m_R_o_w_C_o_l_u_m_n(_3_X).
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                        (printed 11/11/03)
  130.  
  131.  
  132.  
  133.